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Lego Robotics 


Invention System 


part 3: working with Visual BASIC 


By Luc Lemmens — Email: techdept@segment.nl 


In the first two articles in this series, we have become acquainted with 
the hardware and software of the Lego Robotics Invention System. Here, 
in the third article, we see how the RCX block can be programmed using 
Microsoft Visual BASIC or another object-oriented programming 
language. Such a language puts us a lot closer to the hardware, so that we 
can better determine what the robot does. 
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Public Const CLICK SOUND = O 
Public Const BEEP SOUND = 1 
Public Const SWEEP DOWN SOUND = 2 
Public Const SWEEP UP SOUND = 3 
Public Const ERROR SOUND = 4 
Public Const SWEEP FAST SOUND = 
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In the previous articles, we have 
seen that the Robotics Invention Sys- 
tem (RIS) is a very compact package, 
in regard to both the hardware and 
the software. The software is very 
user-friendly, and it should be per- 
fect for the beginner in robotics and 
programming. However, if you really 
want to see what is happening 
inside the RCX block, you will soon 
feel the need for other software 
packages. In this article, we assume 
that you have already worked with 
Visual BASIC. If not, you can find all 
sorts of tutorials on the Internet. A 
very usable course can be found at 
http://emhain.wit.ie/~p98ac25. This 
provides step-by-step directions for 
working with Visual BASIC (VB), and 
also describes how VB can be 
applied to the Lego RCX. Most of the 
tips and tricks described at this site 
can be directly carried over to Delphi 
and Visual C++. 

When the RIS software is 
installed, the ActiveX module 
Spirit.OCX is also installed on the 
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hard disk. The Lego programming 
software utilises this module, but it 
can also be used by 32-bit versions 
of high-level programming lan- 
guages, such as Visual BASIC, Del- 
phi and Visual C++. This means 
that we can use these development 
tools to have a go at the RCX. The 
text box explains how to link this 
OCX to the latest versions of these 
languages. 


The RCX as an object 


Visual BASIC is an object-oriented 
programming language, so it should- 
n't be surprising that it sees the RCX 
as an object with its own properties 
and methods. These are summarised 
in the datasheet at the back of this 
issue. If you're the type of inquisitive 
reader that wants to know all the ins 
and outs of everything, we suggest 
that you visit the Lego MindStorms 
Internet site. At http://www .lego- 
mindstorms.com/ you will find a link 
to a software development kit (SDK), 
which is a somewhat misleading 
name for two zip files: Pbrick.zip and 
GetsStart.zip. The first file contains 
Pbrick.pdf, which is a PDF file that 
contains more than 100 pages of 
extensive descriptions of the func- 
tions of the Spirit.OCX Active-X mod- 
ule. The second file contains a sim- 
ple demonstration application, writ- 
ten in Visual BASIC, that illustrates 
nearly all of the programming tricks. 
Later on, we will have a good look at 
this. 

GetsStart.zip also contains the file 
RCXData.bas, in which all constants 
for the RCX are assigned logical 
names. Naturally, these names can 
only be used in a project if this mod- 
ule is linked in. 

There are three ways you can pro- 
gram the RCX using an object-ori- 
ented programming language. The 
first of these, which probably will 
quickly become boring, is to directly 
control the RCX from a PC. This 
allows you to switch the motors on 
or off, for example, or to read out the 
sensors and call up the value of the 
battery voltage. This is all very nice, 
but if the robot goes out of range of 
the tower, it will simply carry on as 
it was, without any control. In this 
mode of operation, the RCX acts only 
as a glorified interface between the 
PC and the sensors and motors of 
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Linking Spirit.0CX 


— In the Project menu, select ‘Components’. 
— On the Control tab card, check (enable) the option ‘LEGO Pbrickcontrol OLE control 


module’. 


— The Toolbox will now contain a Lego logo that can be placed in a form. 


To link Spirit.OCX to Visual C++ version 6: 


— In the File menu, select ‘New’. 


— Enter a name for the project, and select the application type ‘MFC AppWizard (EXE)’. 
— In the following window, select ‘Dialogue based’. 


— Click on ‘Finish’. 


— In the Project menu, select Add To Project / Components and Controls’. 
— Double click on the folder ‘Registered ActiveX Controls’. In the folder, select the short- 
cut to Spirit Control, click on ‘OK and close the Components and Controls Gallery. 


To link Spirit.OCX to Inprise Delphi version 5: 
— In the Component menu, select ‘Import ActiveX Control’. 
— In the list, select ‘LEGO Pbrick control, OLE control module (Version |.0)’. 


— Click on ‘Install’, and then on ‘OK’. 


— Spirit. OCX will now be shown on the ActiveX control tab card. 


the robot, while the real intelligence 
sits in the PC. 

The second method, which offers 
many possibilities that we already 
find in the Lego software, is to 
develop a program on the PC and 
then download it to the RCX via the 
tower. This of course requires more 
knowledge of the Lego processor 
system, and we will discuss it 
shortly. 

The third method, which is a mix 
of the first two methods, involves 
interactions between a program in 
the PC and the software in the RCX. 
This is of course the cat’s whiskers, 
but it naturally has the same limita- 
tion as the first method, which is 
that the robot must either stay 
within the transmission and recep- 
tion range of the PC, or it must be 
intelligent enough to find its own 
way back to the PC. However, before 
you even start to think about the 
attractive possibilities of interactive 
operation, you must master the first 
two methods. Consequently, in this 
article we only look at programming 
methods. 


Method 1: direct control 
from the PC 


If you load the project GetStart.vbp 
into Visual BASIC, you will immedi- 
ately see Spirit.OCX appear in the 
Toolbox with a Lego logo. If you look 


at the form for this application, you will see 
that it is a very simple sample application. It 
is worthwhile to print out the source code 
and study it carefully, since it will right away 
give you a good idea of how to program and 
control the RCX using this language. 

For the direct control method, the upper- 

most six buttons and the four labels on the 
form are the most important. The ‘Download 
Program’ button applies to the second 
method. 
The buttons that we are interested in here 
provide basic communications with the RCX. 
The topmost button checks whether it is pos- 
sible to communicate with the RCX (in other 
words, whether the tower is connected to the 
PC and the RCX is ‘awake’), the second button 
requests the software version number, and so 
on. None of this is especially remarkable, and 
similar functions are present in the Lego soft- 
ware. For example, you could add buttons to 
allow the motors to be switched on or the 
sensors to be read out. 


Method 2: downloading a pro- 
gram from the PC 


This is what we're actually interested in: 
developing a program in Visual BASIC and 
downloading it to the program memory of the 
RCX. 

As you know, the RCX can hold five differ- 
ent programs, which can be selected using 
the grey ‘Prgm’ button on the module. But 
what is not apparent in the Lego software is 
that each program block can be subdivided 
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Table |. 
Identification numbers for measurement 
values in a data logging session. 


Type number Sequence number 


0 VAR 0-31 
| TIMER 0-3 
9 SENVAL Ones 
14 WATCH 0 
Table 2. 
Sensor types and identification numbers. 
Number Constant Sensor type 
0 NO _ TYPE none 
l SWITCH_TYPE switch 
2 TEMP_TYPE temperature 
3 LIGHT TYPE light 
4 ANGLE TYPE angular 


into eight subroutines and ten tasks. The sub- 
routines can be called from all tasks. Each 
task carries out one specific job, such as read- 
ing in a sensor or driving a motor. Whenever a 
program is started, task 0 is automatically 
activated, and it usually looks after starting 
any other tasks that may be present. We thus 
have a multitasking system, with up to ten 
tasks that can be executed in parallel. Each 
program block must contain at least one task, 
and subroutines are optional. 

If you look at the source code for the 
‘Download Program’ button, you will recog- 
nise this structure in a very simple example. 
The first thing that happens is that a program 
block is selected using the ‘SelectPrgm’ 
method, and the value ‘0’ is assigned to the 
constant MotorControl at the beginning of the 
program. Note that program blocks are num- 
bered 1 through 5 in the RCX, while in Visual 
BASIC they are numbered 0 through 4. Next, 
task O is defined, with the logical name 


Table 3. Possible sensor modes. 


Constant 

RAW MODE 

BOOL MODE 

TRANS COUNT MODE 
PERIOD _ COUNT MODE 
PERCENT MODE 
CELSIUS MODE 
FAHRENHEIT MODE 
ANGLE _ MODE 


Number 
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‘MotorOnOff’. The RCX functions 
(such as PbrickCtr.Wait) are always 
called within this task. 

As already noted, this is just a 
simple example with only one task. 
A more complicated program will 
have more than one task, and task 0 
essentially only starts the other 
tasks, in addition to performing 
some initialisation. If you click on the 
‘Download Program’ button in Visual 
BASIC, the program is downloaded 
to the memory of the RCX. The user 
must then select program block 1 
using the grey button, and then start 
the program using the green ‘Run’ 
button. 


Is it Visual BASIC or... 


In the previous example, only direct 
commands were used in the RCX 
program. However, Spirit.OCX also 
recognises all sorts of control struc- 
tures (such as Loop — End Loop, 
While - EndWhile and so on) that 
can be included in an RCX program. 
VB is actually nothing more than a 
shell, in which a program is recorded 
in a dialect resembling BASIC. This 
is why we earlier remarked that 
everything we have to say about VB 
can also be directly applied to Delphi 
and C++. The ‘RCX dialect’ is so 
similar to other programming lan- 
guages that most of its functions and 
instructions do not need much expla- 
nation. For this reason, we will limit 
ourselves as much as possible to 
things that are specific to RCX. 


RCX internals 


From the perspective of the Lego 
software, the RCX is nothing more 
than an intelligent block with all 
sorts of attached sensors and 


Sensor mode 
6 9 


raw 
boolean 


Description 
data 0 — 1023 
TRUE or FALSE 
transition counter 
period counter 
percentage 
Celsius 
Fahrenheit 
angular 


motors, and there is no need to know 
everything that goes on inside that 
yellow-grey object. However, from 
the perspective of Visual BASIC it’s 
a different story, since we have to 
deal with the internal timers and 
memory of the RCX. Consequently, 
we have to look at how to work with 
the RCX at this lower level. 


Variables 


Up to now, we have only used the 
functions of the RCX, but it also has 
room for storing data. It is even pos- 
sible to store a whole series of mea- 
surements or other data, for later 
processing in the PC. 

The RCX has 32 global variables 
(registers) that can contain values 
between -32,768 and 32,767. In prin- 
ciple, this means that all tasks and 
subroutines have access to these 
variables. This means that you have 
to be careful in the software not to 
unintentionally allow one task to 
modify a variable that is needed by 
another task. This can be most eas- 
ily accomplished by giving each task 
exclusive access to certain registers, 
but this means that the tasks cannot 
exchange data. A more elegant solu- 
tion is to use semaphores. A sema- 
phore is a register (for example) that 
indicates whether a task is allowed 
access to the global variables, and if 
so which task. Other tasks must 
then wait until this task releases the 
registers. The semaphore register 
can for example have the value ‘0’ 
when all registers are freely accessi- 
ble. A task can reserve the registers 
by writing a unique value (which is 
assigned to the task) to the sema- 
phore register. All other tasks can 
then access the registers only after 
the semaphore register once again 


counts level changes 

counts complete periods (negative edge + positive edge) 
sensor value as a percentage of full scale 

temperature in degrees Celsius 

temperature in degrees Fahrenheit 

rotation in terms of number of steps 
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has a value of ‘0’. This means that 
each task must release the registers 
when it no longer needs the global 
variables (for the time being). By the 
way, this difficulty should be elimi- 
nated in version 2.0 of the RIS 
firmware, which allows local vari- 
ables to be used (the pre-alpha 
release of version 2.0 is available at 
the MindStorms site). However, 
since this possibility is (not yet) 
implemented in the Spirit.OCX mod- 
ule, we cannot make use of it in this 
context. However, Lego has added 
its own scripting language to the 
new version of the firmware, and 
this does incorporate all the new 
possibilities. 

Any register can of course be read 
and written, using the Poll and Set- 
Var methods respectively. Spirit. OCX 
also includes a collection of arith- 
metic and logical operators that can 
be applied to variables. 

The RCX can also be used as a 
data logger. The values of timers, 
variables, sensors and the internal 
clock of the RCX can be logged. For 
each ‘measurement value’, the type, 
sequence number and value are 
stored. Table 1 lists the type and 
sequence numbers that are stored in 
the RCX memory for data logging. 

The first thing you must do is to 
use the SetDatalog method to spec- 
ify how many measurement values 
you want to store. This method 
returns a logical variable that indi- 
cates whether sufficient memory 
space is available. Normally, there 
should be enough room for around 
2000 measurement values. However, 
it is always a good idea to check the 
logical value of SetDatalog using the 
following construction: 


Lf 
PBrickCtrl.SetDatalog(size) 
then 

‘enough room 
else 

‘too little room 


If there is enough room for the block 
of data, a small black circle will 
appear at the right of the RCX dis- 
play. This will be filled in during the 
logging session, one quadrant ata 
time, according to how many values 
have been stored in the memory. 
After the SetDatalog method has 
been used, values can be stored dur- 
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Figure |. Asample application in Visual BASIC. 


ing the logging session using Data- 
logNext. Finally, all the data logged 
during the session can be uploaded 
using the UploadDatalog function. 
The RCX sends the PC a three- 
dimensional array containing the 
previously mentioned values. If we 
for convenience assume that the 
array containing the values is named 
DatalogArray in VB, then the array 
element DatalogArray (0,0,2) holds 
the number of measurement values 
obtained during the session. 


Motors 


Various functions related to control- 
ling the motors are available. The 
names of these methods are self- 
explanatory: On, Off, SetFwd, 
SetRwd, AlterDir and SetPower. 


Sensors 


In the Lego software, a block that 
belongs to the desired type of sensor 
can be selected, and this naturally 
must be declared in VB as well. For 
this, we use the function SetSen- 
sorType, which has two parameters. 
The first parameter is the number of 
the input to which the sensor is con- 


nected, and the second parameter is the sen- 
sor type. Table 2 lists the possible types of 
sensors. 

With the method SetSensorMode, we can 
specify the working mode of a sensor, or in 
other words, what values we expect to 
receive from the sensor (see Table 3). 

The function Poll is used to read the value 
of a sensor, in the same way as it is used to 
read variables (registers). 


Conclusion 


In this instalment, we have seen how the 
RCX can be programmed using Visual BASIC. 
It clearly does not matter all that much which 
high-level language we use, since the actual 
control of the this oversized Lego block takes 
place via functions that are defined in 
Spirit.OCX. 

In the next instalment of the series, we 
give our attention to communications 
between two RCX blocks, and we will work 
with a real robot. 
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